import { LoadScriptOptions, LoadStylesheetOptions } from './types.js';
import { ActDepsConfig } from './deps.js';
/**
 * Dynamically inject a <script> tag and resolve when loaded.
 * Subsequent calls with the same URL return immediately (idempotent).
 * No-ops on the server (SSR).
 *
 * @example
 * await loadScript('https://cdn.jsdelivr.net/npm/canvas-confetti@1.9.3/dist/confetti.browser.min.js');
 * window.confetti({ particleCount: 150, spread: 70 });
 */
export declare function loadScript(url: string, opts?: LoadScriptOptions): Promise<void>;
/**
 * Dynamically inject a <link rel="stylesheet"> and resolve when loaded.
 * Subsequent calls with the same href return immediately (idempotent).
 * No-ops on the server (SSR).
 *
 * @example
 * await loadStylesheet('https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css');
 */
export declare function loadStylesheet(href: string, opts?: LoadStylesheetOptions): Promise<void>;
/**
 * Inject a <script type="importmap"> so bare CDN imports resolve in the browser.
 * Must be called before any ES module scripts that use bare specifiers.
 * No-ops if an import map already exists or on the server (SSR).
 *
 * @example
 * defineImportMap({ lodash: 'https://esm.sh/lodash@4.17.21' })
 * // then: import _ from 'lodash' works in <script type="module">
 */
export declare function defineImportMap(map: Record<string, string>): void;
/**
 * Inject a <link rel="preload"> hint to let the browser prefetch a resource.
 * No-ops on the server (SSR).
 */
export declare function preloadResource(href: string, as: 'script' | 'style' | 'font'): void;
/**
 * Load all packages declared in an actjs deps config.
 * Injects an import map for JS packages and stylesheet links for CSS packages.
 * Intended for IIFE / no-bundler usage. Vite users get this automatically
 * via the actjsPlugin() Vite plugin at build time.
 *
 * @example
 * await useDeps({ provider: 'esm.sh', packages: { lodash: '4.17.21' } })
 */
export declare function useDeps(config: ActDepsConfig): Promise<void>;
/** @internal Reset module-level cache between tests. */
export declare function __resetLoaderState(): void;